IE YSYNC Is the trademark of SOFTIYNG. INC, ZEUS 280 ASSEMBLER 1983 Crystal 
1 omputing. Documentation sind packaging ^ if SOFTSYNC, ING, Unauthorized 


‘puoduction, tending, or hiring s prohibited, 


90-DAY LIMITED WARRANTY 
SERVICE POLICY 


SOFTSYNC warrants to the original consumer purchaser of any 

product it manutacturers, that the product wil be free of detects 

in material or workmanship for 90 days from the date of purchase 
under normat -house us. 


I your produc! fas to operate properly DURING THE FIRST 90 
DAYS AFTER PURCHASE, return i postage prepaid and insured, 
with your name, address, proot of the date of purchase and a briot 
ascription of the problem, to SOF TSYNG as ted. IT Tho product 
is found to be factory dotactive during he frs 90 days, i will be 
repaired or replaced ai no cost to you W Ihe product is found o 
have been consumer dimer! or abused it hertore wil not be 
‘covered by the warranty, thon you will be advised In advance of. 
repair costs. 


SOF TSYNC's solo and oxctusive Kablly for detocts in materia 
and workmanship shall be hited fo tapai or replacement asit 
authorized Service Staion and SOF TSYNG shall in no event be 
Nate for incidental, consequential contingent or any other dam- 
ages. (Some staton do not alow the exclusion or imitation of 
Incidenta or concequential damage, «o the above limitation or. 
exclusion may not apply to you). This warranty does not obligata 
SOFTSYNC to bear Ihe cost of Mansportalon charges in connoc: 
tion with Ihe repair or rplicimment a deliclive paris 



































This warranty ts invalid it he domata or detect is caused by 
accident, act of God. consumer abusa, unauthorized alteration 
or repair. vandalism or misuse 








This warranty gives you speci legat rights, and you may have 
other rights whieh vary from state to stato. 


W the product requires service atter expiration of the 90 day Lim- 
Med Warranty period, SOFTSYNG wil service the product and 
uin working condition or replace Ht wil a reconditioned unit 
(at our option). «everpt of the product, postage prepaid and 
insured, with your check in tha amount el $2 for cassette, $5 for. 
diskette and $10 for cartridge payable to SOFTSYNC, ING 














AN returns must be direct to 


SOFTSYNC zi. 

M East 34th Street 

New York, NY 10016 

For service Information, callt?t2) 885-2080 from 9/00 a m to 
8.00 pm Eastern tme Monday thru Friday 
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Vwther facilities available 


INTRODUCTION 


Welcome to ZIS the asembler hased machine eie operating system for 
the ZX Speer 


VUS p 
compa 





des the opium method For writing 280 machine code on 


d yet, as yr oil soll discover it fs even easier to nse than OS 





The heart of ZEUS is a Beh speed twips assembler designed to allow the 
convenient syinhwli chine cde program: lines of 
assembly f wones (machine crie intractions are entered as imply at 
Yn wouhi enter a RASH proram. Bhat heve the similarity with other assemblers 
emits, for the tre power nl ZEUS stems from the uni ‘oF its operating 
system, Just ws the Sinclair OM enables you to write RASIC, so ZEUS provides all 
the Facilities your ned to preshice machine ere programs quickly aml efficiently 




















j 
1 


The follen 
definitio 





yout the vest of this manual and their. 
are provided here for those unfamiliar with assembler terminology. 





SOURCE FIL 


Mower cons 


SYMIOL 





The text, inching all awembly language mnemonics, Ibels 
and comments is collectively known as the sige fle 





The object code Hs the machine code produced by ZEUS from. 
Ihe sone file. 


A yinbo bx a string of al phammerke characters used to represent 

verc value (either dota s an address), 

A label isa special type of sym He vale of whieh corresponde 
‘the naires ofthe instenction which immediately follows it 








DIRECTIVES An assembler directive ds not am actual ZAO instruction bur 
Fepresents an onler given hy the programmer fo the assembler 
which velis in the storing af values. either into symbols or 


memory. 














SECTION 1 

DADING AND RUNNING 
M yon wish 

before plugging in yo 
1. Rewind the cassette to the beginning of ether side, 





us 





ie the Z printer with ZEUS they remember to connect it up. 
Spectrum, 





2 Set the volume on yo 
treble. 


3. Connect the EAR ucket on your wearder to the FAR socket at the renr of 
the computer. 


ever Vo aout. main amd the tone 1a full 











A. Type LOAD "rens" or simply LOAD", Press ENTER and start the tape. 
5. ZEUS will autorun on losing, displaying the copyripht message ani Nashin 
cursor, 





FCTION 2 
WRITING MACHINE CODE 

This section is a description nf the entey ofa shert machine cole vobramntine 
which, along with the program itself, lur een writen to iustrace some wl the 
featues of ZEI 

The program loads byte 255 into each address (memey focation) on the 
screen, The screen i 6141 bytes in length and stars at address 16384. The ow thine 
ie with it BASIC equivalent s follis 





I ZEUS 





wr 











‘of the progra 














10 IL wom SeLE 
LD peoa SILT prete ws 
1D A255 StyLET Aea5s 
1DUROA SIVBTOKE HA - 
Ibne SMOLET GIAI 

bop LD AGH SAGOLET A«PEEK IL A 
LOWE) SMPPOKE DEA : 
nent spot menia 
p sepu DEDE 
pee we ser neca 
DAK iiir HC <> PTEN GOTO 5950 
one SLIP RETURN 
INZ ioo 
wr 


Fly, leur the screen by prowing CAPSIIFTETD SP (equivlent to 
yraphic mode in Sinh BASIC) 





ering 


Entering Hnes wf text i very similar fo waiting. a MASIC program, Each line 
amunt he prefixed by à umber which may fake any value fsom Mo 65534 inchnive. 
MR Important tos reiner that, providing the Hine the enro iron begins with a 
valid ie. imber, preme ENTE will inert that line atthe correct position in 
The sence fie vo repta anv previews ine which had the same mimber. 














The commun jo tell ZEUS o. provide Ine m 
the form 





rs automaticaly is of 


where x 


are calle "praelo hee 
wall se hen Me 






valves which the. 
wes. For example, im a long BASIC program you 


usi le: 


Here, the parameter 1980 causes the command to e 
ie 





may we 





mence listing from line 


To illustrate the we of prameters type: 


1100109 
and press. ENTER several times. To exi 
ilelete the ciment fs 
press ENTER 





from autodine number mode simply 
miner fee with CLEARLINE- CAPSHIFTED 71) and 





Cleat the screen (CAPSUIFTED *9" 
times, As you have not specified particular values for the parameters x and y, 
ZEUS has used the ‘default? values which are x=10 and y=1@. To take an example 
from BASIC, the default value of the LIST command parameter is the first Jine 


P 


To 





type T and press 









the first few Vines of text 














1, Clear the screen (CAPSHIFTED 999) 

3 Type T followed hy ENTER (once only) 

3o Typen the following tines of text, pressing ENTER after 
emh o insert the ne in the souree file ond to produce the 
ment line m 

1D ILA 388 
VD DI GARS 
Vp A2SS 
pain. A 
Vp HEH 
M you enter a character incorrectly wse PRASE 
ACAPSHIFTI D P) and re-type. 
4. Ft from adipe mier mode (CAPSHIF TED *1* 





followed by ENTERO, 


Yen may now use the full screen editor which, ay the name suprests allows 
i text te be ete hy arm it as i displayed on the screen. 





dy V is necessary ta obtain a sting of the somree fle, Clear the sereen 









amd enter (hott for LIST), The LIST command takes up fo three parameters 
ef the 
| Laye 
where tine mimber to iet om 
= line mimber to st up to 
‘= mnnber of ines to list before pausing 
o alter a particular. character in the text use the cursor control evs 





ST CR) Mo mee the cursor to the desired point in 1 
inly type im the replacement character. The cursor wall move anto- 

ally to the nest character position. Remember Hat the motifiei line will only 
he incerted into the text on pressing ENTER when the cursor is sitting vn that Tine, 











For example, to change line 3$ to read. 

90010 LD A254 
fal the text and wing the cursor control keys place the 
lipit. Type *4' amd press 
iher hack to 


firstly obtain a Tis 
cursor in the same character square as the right hand 
UNTER, CLEARSCREEN and LIST. You may mow change the nu 
285 either by the sume method or by entering 

3$ 1D A255 
ve CLEARSCREFN and LIST. 











Refine 





The next pet f the program involves a loop. I is often desirable to indent 
loops in onder to snake a program more readable. To spoed the proces of entering 
sections of Indented text, ZEUS provider a "user definable’ TAB facility, The TAM 
tops may he se wp oom within the Monitor. Type °M and press ENTER. The 
word "Monitor appears f rem 

more the cursor any unt Hine up with the clan of "Lv in 
the lop of the sereen, Now type a now space character (eg. "I followed hy, af 
S spaces, a futher "I and ENTER. CAPSIIFTED 7? will now move le cursar 
to the stops ym e Jast define 













Retum to ZEUS (enter Z°). Now you are ready to add the loop. Fiatly enter 
4169" to invoke sate liae numbering from line 6B. Type in the wand Tonp' (which 
yon may wish i put in lower case characters hy wing the CAPSHIFT key), Use. 
CAPSHIETED "2" to put the curs at the next FAR atop. Now type. 

IDA 


amd pres ENTER. Fries ie following liner remembering to indent by using 
CAPSIITED 2 











LADERA 
[D 
INE DE 
rene 
iDan 
we 
IR NZ onp 
Nite that each reference to a particular abel 


for character, tie that labo Herve if yont have wed fos 
mist de the saree He LR 





Enter the last Hw wi the lent, le 
MH RET 


nt fom anten. e (CAPSHIE TED. 








Two adilitinsl Fines ane necessary. beore you cam assemble and test 1l 
routine. Firstly. you unist ll ZEVS where to place the assembled code by using. 
the directive ORG. 


Fnter. son Non 
to anembe the machine code from memory location Af. 


Secendlly sii nist se om entry pon, Fe. the point f 
command CX) will un she code Poter 





which the execute 


m 


followed by CLEARSCREEN and LIST. 





“You will notice hat it is necessary to press ENTER twice to list the complete 
source file, This is because the default value for the z parameter (mimber of limes 
‘to Ist before pausing) is 14 anil the source listing is now 16 lines long, 








guy ZEUS ah entre a renumber command of the Frm 
Rxyz 
See ZEUS Assembler commands (Section 4} for definition of the parameters. 


To sewmnber the source file, enter *R’. Now list the fist Hines by typing: 
[e 

and pressing ENTER once only. Note that the use of a comma to replace a par- 

ameter causes the command to use the def value of that parameter. Yon can see. 


the source has heen renumbered in accordance with the default values of the 
‘comand 











Check carefully that the source ile is identical to the following: 
PIP ORG 10000 
99020 ENT 
919 LD HLGIA 
0919 LD DE,163RS 
POSO LD A255 
OON ED MJA 
[ITE 
UO loop LD A, (IL) 
WA LD (DE) A 


(eee en 
orig INC DE 
om Decne 

e^ eo LDA 
(map ORC 
PMSA IR NZ loop 
(nee RET 


Now you are ready to assemble the source file to produce the object code, 
commonly called the machine eode. Type *A’ (short for ‘asemble’) and press 
ENTER, 





mistake, am error report will have been Issued followed by the 
he error y not apparent, conli he appendix on emv report eones, 








Athi ste Ye emet stake ho make t wit a yace from wit 
iutracion, Thin wil puede err P fincoplte statement}. Yom may find i 
worthwhile to purpoehy introdice hy. for example, removing the space KPO 
Tow 30. (CLVARSCIIYN, LIST, pce the "e space between "De 
T, DELVE CAPSHIE ADU), ATH CLFARSC REEN, ASSE MILE 











You should see 






Vr 
010 1 DIL 634 
To correct the ener, move the cursor to the SH a INSERT 
KCAPSHIE TED ^E) to bl the spice, ASSEMBLE, CLUARSCREEN and 


HIST. 


M is adis to save the source. file on tape prior to exec 
Loading and saving js necomplished by inr the BASIC commands and 
renting the source ile as a Mock nf data bytes. 














The BASIC command to sive à block of bytes is of the form: 
SAVE" 


where x 





ime" CODE x,y 
dress of the ist data byte 
y 7 length of data 


‘The values ol the parameters x and y are given by the 
Enter "T and you should see 








Sn of source = 32768 
m = oa 
Return to BASIC by entering "O (short for QUERY am use (P9 
SAVE "source 1” CODE 3276N,144 
to save the source to tape: Cheek your recording with 
VERIFY * "conr 
To return to ZEUS enter 


PRINT USR 57344 


^, 


Before you can fist the source you must enter ‘O° to tell ZEUS to 
retrieve the old source file. The ‘O° command can alo take à parameter, 
that being the start address of the file it is fo retrieve. 











You may create a source file at a different address hy either 





Using the "N* (short for NEW) command before you enter the 
program, The parameter specifies. the address from which the 
source will be wilt, or 

i) Reloading an ok! source file to a different location to that from 
which it was saved (scc Section 4, "T* Command), 








When you commenced. entering lines of text, ZEUS automatically 
«d the source from the default value of the "N command, ie, adress 
i8 Cor NO hex.) 
If you have a ZX printer attached then 
of the source file, To turn the printer ‘on’, enter M 
L,,16 

When the printer is "on all output sent to the VDU, is ao sent to 
the printer, To tum the printer ‘of enter PO. You may interit the 
printer by using the BASIC BREAK key, Return to ZEUS m the non 
way. 








may make a "hand copy” 
Now enter 















‘You are now realy to test the routine, Ente 
Wf all well the sereen (apart fro 


"(short for EXECUTED, 
the border) will fill with the current ink 
colour Ge. white), M this does not happen, list the source and check it 
carefully apainst the listing above. Y the computer "crashes? simply relovid 
ZEUS, QUIT and Joad the source file using LOAD * " CODE. Remember 
to use the "O* command to retrieve the old source file 






1a this section you will have gained an appreciation of the way ZEUS 
can he wed to produce a simple subroutine. Yet there are many additional 
Features at your disposal to aid the programming of more complex routines. 

t section provides a comprehensive description of these and also 
AN nanidates the features already mentioned. 















SECTION 3 
ENTERING AND EDITING TEXT 
3.1 General format 


ZEUS uses the ASCH character sel. To enter assembly language 
ns you must Firstly type in a Tine number and follow it with the 











required line of test, The line mimber must Hie in the range Ø — 65534 
inclusive, 


‘The text must consist ef one or more statements separated by colons. 
Fach statement coinprisesz 





nare em ^ 
P Animimilon 5 
©) An optional comment 





a) Optional label 
"The following rutes overn the use of label 


' » 
d) A labet must start with a letter, 


A label may ca 





upper and lower case letters and digits, 








Wi) Lahels can be wp to 14 characters in length, 
WW) A label must not be identical fo a reserved word (ep. using *LD* 
[ an a tabel ts not ted). However, a label may contain re- 
served words Cop. "HELD! would be vali), For a list of reserved 
words see appendix three, 
v» ^h 


Note that every n 
varaeter for chori 














of must be seperated f 





an instruction by a space. 






o à particular Label must be identical, 
abe 











P Instruction 


An instruction: 
Hi may he 
hy ZEUS f 
anay refer to 


ay he any of the standard Zilog Z80 instructions or 
aswmbler directive (sev below). An extra facility is provided 
referring. to the parity overllow Mag. When usi 

np overHow" instead of "4 
















may be written IPV, 
IP NY, 


ly interchangeable hut their w 
iprehensible, 


A JP nO, 


The two versions are comple 
make a routine more reality on 





may be writes 








v Optional comment 
A comment may he appended 1o the end of any instrictio 
be seperated from the instruction hy a semicolon. Lines c 
»mments are also allow 





12 Constants 


Constants moy he expressed either in decimal or hexadecimal form as 


follows: 








Decimal. 1 w9 2344996, 
Mexadecimal: #A (vk  #6RA3 #5C0 
Literals can be expressed as follows 
"A "t pe 





example, to Toad the literal °C* into the accumulator, use: 





1DA,."C 


Note that in 70 convention, parentheses denote an address, 
en LD A, (299) will load the accumulator with the contents of memory 
location 2999 (decimal). 

Finally, there is also a system constant "^ which is set to the current 
assembly address, 


er. 








pINZY isequivalont to loop DINZ loop 
A3 Operators s 


1n onder to farther facilitate the writing of symbolic proprams, ZEUS 
allows the use of logical operators 


The operators provided are: 


* addition 

subtraction 
& Vorical AND 
! lorical OR 


No operator priority i observed; expressions are evaluated strictly 
Fron left to right 
34 Expressions 
Wherever a constant is required in an instruction an expression may be 
used in its place. Expressions are hwill from labels and/or constants 
separated by operators. 
en LD A, (ADDRESStoffset) 
LD HLSTART- 3 
IN A, (PORT & #FF) 
LABEL tPFFOR 


n 








Note that expressions will be computed hy the assembler to determine 
the actual memory location which will be inserted into the object 
Expressions are computed at assembly time, not at program execution 
time. 


as 








Assembler Dires ives 








The following "nsendexoperations either provide parameters for 
operation of ZEUS or instet the assembler to store values either as 
symbols or directly into memory: 


ORG niim Short for ORIGIN. This directive instructs ZEUS to 
awemble the block of machine code (as translated 
from the source fisting after the ORG statement) from 
adress nmm (provided that the current DISP value ix 
ore see helow). 

Multiple ORGs within the same source file are allowed, 
Such ORG statement will rodircct the address from. 
which subseynent code iv assembled, 

Short for DISPLACEMENT. A DIS uction altere 
the place fom which subsequent. code is generated 
even thogh the code so produced ix assembled to run 
LaF he inblress specifies hy Ihe. 
M is sometimes convenient to he able t 

M a Hil erent doc: ne at whi 
wlhinotely intended ple if the lattes 
ovenpiesd at present) onitor may he used to 
relocate the code to th 


























DISP annn 



























Vor example. piven the following two stateme 
Mar ol a source 


ORG 3000 


isat the 











Dist 10000. 
ie chuiree following would he assembled from 4 
but weubl only normally run at 30009. 











ENT 1 an entry point. The "X^ command executes the 
yssembled code from the last. ENT. directive in the 
source file- 

EOU Short for EQUATE or FQUALS. A label (symbol) may 





have a value assigned to it using a statement of the 
hn 
" Tabl KOU value 





DEFS mon 
DEFB mnnn,» 


inserts nnn spaces at the current assembly address 


inserts bytes nn at the current assembly address 





DEFW nnnn,nnnn, „inserts words (addresses) nnnn at the current assembly 


address. 


P^ DEFM/string/ The text enclosed in the ‘/* delimiters will be inserted 


al the current assembly address. 
As with all assembly langnape instructions, directives may be prefixed 
hy a label. 


er DATAL DEFW 490903456, 


I'S DEFR 3,2,14. 
ADDR ENT 





780 











3,6 Screen Editor 


ZEUS provides a full screen editor to facil 
source file 





ate modification of the 





irstly Hist the text by using the L' command. The cursor may now be 
movel fo any point in the listing hy using the cursor control keys 
XCAPSHIETED 5, 6, 7*8) 

Hracter at the current cursor position simply enter 
The cursor will move automatically 1o the next 











the 
character position, 
ace may he inserted into a line at the current cursor position hy 


inverse video key (CAPSHIFTED *4*), The character at the edge 
nis lost. 









The character at the curse 
viden key (CAPSHIFTED 3). 


Having altered the tine, pressing ENTER will insert the new fine in the 
correct place in the text 


Other 








position may be deleted hy using the tine 








^ 








EARSCREEN: The entire screen may be cleared and the cursor placed. 
a the top left hand corner by using the "rraphics key 
(CAPSHITED 9, 


CLEARLIN 





The current fine may be cleared and the curer 
placed at the start of the Tine using the “edit” hey 
(CAPSIIFTED *1') 





IA 


NB. 


B: 


!CHONA 
VUS ASSEMMLER COMMANDS 


vere 


i onstant, Fintry of numerical paran 


» lier ones, this can D 


limiters, Delimiters cm be 


A command consists of a command letter followed hy aay 
V string. parameters 





Numerical 


iat command, 
AF it is desi 


be skinned, 


Lise 


1 
String par 


FALDI 
[EE 


commands 


^" 


Siring” x yz 








This command does not remove the current line from 
the text but simply from the screen, 

The "Caps tock” key (CAPSHIETED 72) moves the 
esor fo the next tab stop on the current fine. The 
tab 

(See Sect 








"5. 











meters consist of either a decimal or à hexadec 
as overwrites the default parameters. 








J to alter a later default. parameter wit 
achieved by entering à comma f 


upsetting 
every parameter 








List the text from start to finish 
List the text from fine 19 to fine SO 
SO Vint the text from the start to line 59 


ed by enclose the string within 
y character except", or W" or any digit, 














ders are repre 








Finds all occurences of the string LDIR 
ditto 





Acomble the source file and 
Alter x errors have been encountered and displayed, 
wembiy will stop. To contine assembly, press 
INTER, DEFAULT: x= 14 m 
Delete all lines between line x amd Fine y inclusively. 

— parameters are given, no action will be taken. 


isplay error messages. 











‘This command searches the source file for all 
nees of the given string. The search commences 
‘at fine x and Finishes at tine y. An 
string are displayed and a pause initiated after z lines 
have heen displayed. 














ps may he set up from within the Monitor gy, 


Ixy 


Pe 


9^ 


Raye 





DEFAULT: x = lowest fine number y = highest tin 
number z= 14 "string" 


After entry of this command, ZEUS will automatically 
generate line numbers, starting with line number x, 
Any text entered will be inserted in the correct place 
in the source file and another line number generated. 
Parameter y is the spacing between successive tine 
tumbers. Deleting the line number amd pressing 
TER will hall auto line numbering, 
DEFAULT: x= 10 y= 10 
List the source file from line x to Tine y. Parameter # 
ives the mumber of lines to be listed before pausing, 
DEFAULT: x = start. y = finish x= 14 


Fnter the Monitor (Sce Section 5) 











Create a new, empty source file at address x, NI care 
must be taken when using this command as phi 
source file al certain locations may cause a crash. 
DEFAULT: x = 32768 (E8000) 

This command causes the “old” source file at address x 
to become the current source; it is usually used to, 
retrieve a sowrce file which has been loaded to addres x. 


DEFAULT: x = 32768 (#8090) 


Printer operation, x * | turns the printer on, Alt 

output to VDU. iv also sent to the ZX printer, Provin 

uses a return to 
Reenter ZEUS a» normal (the printer is 

aitically switched off on re-entry). x = 8 turns 

the printer off, 

DEFAULT: x= 0 

QUIT. Exit to BASIC. To return to ZEUS, enter 


PRINT USR 57344 














BREAK during printer operation 
BASIC 








Re 


x the first new 


number the source file. The parameters are as follows: 








ve number 





y t the spacing between successive new line numbers 


7; the line to start renumbering from. 
DEFAULT: x = 10 y = 19 z = lowest current line 
wher 











Sx Print the symbol table. x gives the number of symbols) Cx yz 
Tabel and their associated hexadecimal values listed 
hetare pausing. 
DIVAULT- x 









































T the st F the current A^ 
Ne in bytes. The file may be saved by returni. «o 
MASIE CO) amd using » Ex 
SAVE “fil CODE start, length Ix 
To relomd an oht source file to. Kxy 
1) the same address ax it was saved from, we 
LOAD "hlename" CODE 
A) a different address, se: 
LOAD "filename" start address 
Jving loaded an otd source file, reenter ZEUS 
(URINE USR 57:44) and enter the command 
O start dress 
to retrieve the source file starting. at ‘start address” 
x Vente the machine code produced by the fast 
awembly, Execution begins at the ENT statement 
nearest to the endl of the source file. Mx 
Hono ENT statement existed. an error message is 
issued 
SECTION $ 


THE MONFFOR 
The eextesilent Monitor allows you to directly inspect and manip 
memory amd the 1/0 ports sid also sel up several options within 


montron consis T We Gillan Rito s prid 


^x Hand the hexadecimal 
se presentilien of the value x which may be of either fom 








AS? prints HEX = #38 DECIMAL =59 
AWA pims HEX =#2A DECIMAL- 42 








Copy a block of memory. This command takes three 
Parameters, as follows: 


x £ start address of block to be copied from 
Ys start address of Mock to he copied to 

z: the number of bytes to copy. 

Execute machine code from aikdress x. 
Print the value of 1/0 port x. 


‘This command allows the border, paper and ink colours to 
be altered. x is the byte which is used to fill the attributes 
table, itis made up of four fields: 


Bits. — 2 control the ink colour 
Bits 3. — 5 control the paper colour. 
Wit 6 is set for "hripht* 

Bit 7 is set for "flash 

y is the required border colour 











eg. K E 1: white ink on bine backpround with blue border 
K 3R 7 : black ink on white background with white 
border. 


Fater modify mode starting at aurem x. 
“The mesify. command provides. an extremely flexible ant 
hence powerful men dol 

For example, 














M (po 
will print 
6009 XX (note the position of the cur 
XX is th ints of adress AWA. You may now 
proceed 
» the address 





Type the new value aver the oM one and press ENTER. 
Meslify prints the next address, (401, along with itv 
present co 

b) Alter the s ef the address amd subsea 
adresses simnlranemidy. 
Type the new valoe For the present address followed 
^y the values to he written in the subsequent aidiesses 
On pressing ENTER, modify will print the address and 
value of the byte after the last one modified 
























Notes: 


Oxy 


w 


Alter the modification address 
Type "f followed by the new address, O 
ENTER, modify will move to the new adress, 
Fxit from modify mode 

Type a Pil stop and pri 





pressing 


s ENTER. 


















Chonictens can he entered by the 

ep aer entering M 6000 overwrite the present value 
with "C. T f the character Y i 
ow at a 





More complex formats can be entered, For example 
6000 42 41 AQ "A "C "D. 
centers the six values. into 6008. 1o. 6905. and leaves 
only monte 
MAM AA AI 49 / 6500 RA RIAA 
enters bytes 4A 41 A into 600. to 6092. N then 
moves the modify adress to 6500 and enters KY RI 
amt KO into adiresses 6509 to 6582. Finally it prints 
A03 followed hy the contents of that adress 
The above sequences can he combined with the "enter 
‘vwnlily mde! command CM?) 





M eo 2s 
enters modily mode, puts FE into 6080 and 42 into 
CT and heaves madify mode, 





Output the value y to NO port X. 
Set VAI stops, Any non space character on the sime ine 
vs the N^ will define a TAB stop (provided the line is 
entero), CAPSHIETED. 2" advances the cursor between 
the taps 





1 1 
se TAR stops at the columns occupied hy the "I" ch 








TAEUN tise. om eat dot mel mye 
mv sel itt brin ata ne i endis m 
Favs line a prefixed y tha abiret of the fint he anf 
lin. After y es ive been displayed, tabulation wil 
To ruine: preat ENTER any olet kny mil ranura you 
Ia ri annama se 

















Mote that is 





is posite to modify memory hy the following. 
methot: tabulate the required area of memory as deserihei 
above and after returning to command mode, enter modify 
mide CM), Using the cursor control keys, move the curso 


vip into the tabulated fisting. After altering all the req 








of quotes, fm Az Ren 


values on a given line press ENTER to modify the actuat 
nemory locations. 





Exit from modify mode as before by typing à full stop and 
pressing ENTER. 








m control to the asembler 
Note that all constants entered in the Monitor must be hexadecimal (with 


the exception of the ‘A’ command which, like the assembler defaults to 
decimal; prefix hex values with a "f symbol) 








APPENDIX 1 
Commas at 


f Assembler 

Ar ASSEMBLE. Print x errors at a time, 

Pay DELETE tom tine x to fine y inclusive, 

J "string'*xy 2 FIND "string? between line x and line y. print 
oxeusences at » time. 














Ixy INSERT (ante line number) starting at line x with 
increments of y. 

Ley LIST trom Fox « to ine y in steps of lines. 

M Vater MONITOR, 

Nx Create à NEW sonrce file at address x. 

ox Recover OLD source fie at address x. 

Px PRINTER contrat: x o @ for "oft" 1 for ‘on’ 

D QUIT. Wetum to BASIC 

Raya RENE MEIC the source file from line 7 to commence with 
Hine amd kavements of y, 

sx Print the SYMBOL TARUE x Hives at a fime. 





' Display the star address amd tengih of the source file 
` VXPCUHL object code at fast ENT statement 





Wh Monitor 





Ax rint «in aloitat and hex, 

taya COPY a Mock of memory from address x fo adidress y for a 
ent z bytes 

m TEXTE 







n Prnt the val 
hay Set p th 








Mx Vintes MODIEY mode at address x. 
oxy OUTPUT byte y fo HO port x 

s SET up the FAN stops 

Tay TABULATI memory frown address v, y lines at a time. 
a Wetuin e He wssembler 


UH Sereen Editor 

APSHIFTED 1° Ceti") containing the cursor. 
— tock) Move the cursor to the next TAR stop 

APSHIETED ‘3° (True video’) — Delete the chazacter under the ewrsor 

APSHIFTED "A (Inv. viles?) Insert a space character at the cursor 

position 
CAPSHIETED °S', "6°, °7° & °° ate the cursor directional control keys 
CAPSHIETED “ Ceraphice’) Clear the screen am! home the cursor 

















APPENDIX TWO. 








Error Report Codes 
NUMBER MEANING. 
D Mepal character or incomplete statement 
1 
E Truncation error or jump out of ranpe 
4 expected 
s Context error 
6 Redefined label 
7 °C symbol expected 
* Megat mnemonic 
` Undefined label. 
APPENDIX THREE 
Reserved Words £ 


The Following is à list of reserved words, ie. those which mist not be used 
as labets, although any label may contain them. 


A ADE 
E CN 





ADD AP APO AND HW — nco WT 
CCF œ CPD CPR CPL CHIR CPI. 


DAA DE DEC DEFA DEFM ders DEEW DI 
DNZ E — Wi — ENT FOU EX EXX M 
[NET MO IN INC IND INDR INI 
X av OP ORO LO D LDD LDR 
LDR M — NC NEG NOP NV NZ OR 
ONG omr OTIR OUT OUTD OUI P è PE PO 
POP PUSH RES REF RETI RETN RL RIA RLC 
RECA RID RR RRA RRC RRCA RRD RST SRC 
SCP SET StA SPO SRA SRO SUR VO XOR 
APPENDIX FOUR 
Zeus memory map 


The following areas of memory are used hy ZEUS: 
A) ZEUS machine code 
and workspace — $7344 65279 (HEM — #FFOM 


EJ 





* 

(B) Source file Initially starts at 32768 (#8000) but 

jt may be altered with the ^N' command. 

©} Assembled Code Defined by the user through the 
(Object code) directives ORG & DISP a 


D) Symbol Table This is the taMe which contains the 





associated values, It starts at 57343 alid 
increases in size downwanls at a rate of 
sixteen bytes per label used, 


© Note: if the symbol table (produced on assembly) becomes close 
enough to the source to he in danger of overwriting t, the mewape 
ý * Ot of symbol space * 
is imed, Similarly if, when entering text, the source file becomes too 
clove to ZEUS the messape 
* Out of mem 






is produced. 

IF either of these occur the source fle must he moved down in 
memory. This can be done using the Monitor "COPY" command. However, 
preat care shoul! Ge exercised to ensure that, if necessary, RAMTOP is 
redefined using the BASIC command CLEAR before copying down, 





APPENDIX FIVE 
Useful Zeus routines 


You may wish to call some of the following ZEUS subroutines from 
your own programs 

NAME ADDRESS — FUNCTION 

INPUTCHAR — 4e Wait for a key fo be pressed; result in A. 
PRRITCHAR — rss Print char in A. May also he a control 
character (see below). If printer flag is 
non zero will also output to printer. 
Write HL in decimal followed by a space. 
Write A in hex followed by a space 
Write HL in hex followed by a sp 
Write the string following the call; 
string must be terminated by byte zero. 
Enter screen editor, put line which 
cursor is on in buffer 

32 character buffer terminated by a 
byte zero 

Non-zero to enable printer 

Print decimal number in HL without 
Jeading zeroes 











PRINTDECIMAL #ESA) 
PRINTHEXBYTE #F2DF 
PRINTHEXWORD E571 
PRINTSTRING — #E4h3 





INPUTLINE — -# FOE? 
BUFFER #FEBO 


PRINTESFLAG  #F Aca 
PRINTDECNZ — &F*or 





Notes: 1) AN prints send characters to the printer as well as VDU. 
if PRINTERFLAG is non-zero 
2) PRINTCHAR also allows the use of screen editing commands, 
For example, printing byte #9F will clear the screen, 
The list of editor control characters is as follows: 
#94 Delete character under cursor 
#95 Insert space at cursor position 
#06 Move cursor position to next tab position 
#07 Clear line containing cursor. 
#08 Movecunorleft 
#99 Move cursor right 
#9A Move cursor down 
#98 Move cursor up 
FC Move cursor left and blank character under cunor. 
AD — Move cunor to beginning of next line. 
Scroll if on bottom line 
HOF Clear screen and cursor home 


APPENDIX SIX ‘ 
Further machine code facilities from Crystal Computing: 
ZX Spectrum Machine Code Monitor and Disassembler Package, 


‘This program provides additional facilities to aid the inspection, analysis. 
debugging of your routines; with this and ZI'US co-resident in memory 
ipectnum hecomes a truely comprehensive ZRO programming unit, 





you 
NB, When you intend to use both programs at once, lod ZEUS in 
FIRST, then QUIT and load in the 16 K Monitor and Disaseembler, You 
may enter both utilities seperately, hut it i convenient to enter ZEUS by 
Using the Monitor command: 
Goto EN 


The use of the ZEUS command QUIT will then return control to the 
Monitor and Dissassembler. 





^ 


22 


